###User Defined Function###
_WinAPI_GetSysColor

###Description###
Gibt die aktuelle Farbe des angegebenen Anzeigeelements zurck

###Syntax###
#include <WinAPI.au3>
_WinAPI_GetSysColor ( $iIndex )


###Parameters###
@@ParamTable@@
$iIndex
	Das Anzeigeelement, dessen Farbe abgefragt werden soll. Kann einer der folgenden Werte sein:
	$COLOR_3DDKSHADOW - Dunkler Schatten 3-dimensionaler Anzeigeelemente
	$COLOR_3DFACE - Vordergrundfarbe 3-dimensionaler Anzeigeelemente oder Hintergrundfarbe von Dialogboxen
	$COLOR_3DHIGHLIGHT - Hervorgehobene Farbe fr 3-dimensionale Anzeigeelemente (fr der Lichtquelle zugewandte Kanten)
	$COLOR_3DHILIGHT - Hervorgehobene Farbe fr 3-dimensionale Anzeigeelemente (fr der Lichtquelle zugewandte Kanten))
	$COLOR_3DLIGHT - Beleuchtete Farbe fr 3-dimensionale Anzeigeelemente (fr der Lichtquelle zugewandte Kanten)
	$COLOR_3DSHADOW - Schattenfarbe fr 3-dimensionale Anzeigeelemente (fr der Lichtquelle gegenberliegende Kanten)
	$COLOR_ACTIVEBORDER - Randfarbe des aktiven Fensters
	$COLOR_ACTIVECAPTION - Farbe der Titelleiste des aktiven Fensters
	  Gibt die Farbe der linken Seite eines aktiven Fenstertitels an, falls ein Farbverlauf fr Titelleisten eingestellt ist
	$COLOR_APPWORKSPACE - Hintergrundfarbe von MDI-Anwendungen (Mehrfach-Dokumentenansicht)
	$COLOR_BACKGROUND - Desktop-Hintergrundfarbe
	$COLOR_BTNFACE - Vordergrundfarbe 3-dimensionaler Anzeigeelemente oder Hintergrundfarbe von Dialogboxen
	$COLOR_BTNHIGHLIGHT - Hervorgehobene Farbe fr 3-dimensionale Anzeigeelemente (fr der Lichtquelle zugewandte Kanten)
	$COLOR_BTNHILIGHT - Hervorgehobene Farbe fr 3-dimensionale Anzeigeelemente (fr der Lichtquelle zugewandte Kanten)
	$COLOR_BTNSHADOW - Schattenfarbe fr 3-dimensionale Anzeigeelemente (fr der Lichtquelle gegenberliegende Kanten)
	$COLOR_BTNTEXT - Textfarbe fr Pushbuttons
	$COLOR_CAPTIONTEXT - Textfarbe fr Beschriftungen, Grenauswahlboxen und Scroll-Leisten-Pfeilen
	$COLOR_DESKTOP - Desktop-Hintergrundfarbe
	$COLOR_GRADIENTACTIVECAPTION - Farbe der rechten Seite eines aktiven Fenstertitels 
	  $COLOR_ACTIVECAPTION gibt die Farbe der linken Seite an
	  Um zu ermitteln, ob der Farbverlauf fr Fenstertitel aktiviert ist, verwende den Parameter <b>SPI_GETGRADIENTCAPTIONS</b> mit der <b>SystemParametersInfo</b>-Funktion
	$COLOR_GRADIENTINACTIVECAPTION - Farbe der rechten Seite eines deaktivierten Fenstertitels
	  $COLOR_INACTIVECAPTION gibt die Farbe der linken Seite an
	$COLOR_GRAYTEXT - Farbe eines ausgegrauten (deaktivierten) Textes. Dieser Farbwert wird auf 0 gesetzt, wenn der aktuelle Anzeigetreiber keine Graustufen untersttzt.
	$COLOR_HIGHLIGHT - Farbe ausgewhlter Eintrge (Items)
	$COLOR_HIGHLIGHTTEXT - Textfarbe ausgewhlter Eintrge
	$COLOR_HOTLIGHT - Farbe eine Hyperlinks oder eines per Hot-Tracking markierten Controls
	$COLOR_INACTIVEBORDER - Farbe eines inaktiven Fensterrahmens
	$COLOR_INACTIVECAPTION - Farbe der Beschriftung eines inaktiven Fensters
	  Gibt die Farbe der linken Seite eines inaktiven Fenstertitels an, falls ein Farbverlauf fr Titelleisten eingestellt ist
	$COLOR_INACTIVECAPTIONTEXT - Farbe des Textes eines inaktiven Fensters
	$COLOR_INFOBK - Hintergrundfarbe fr Tooltips
	$COLOR_INFOTEXT - Textfarbe fr Tooltips
	$COLOR_MENU - Men-Hintergrundfarbe
	$COLOR_MENUHILIGHT - Farbe, die benutzt wird, um einen Meneintrag hervorzuheben (wenn der flache Stil eingestellt ist).
	  Der markierte Meneintrag ist mit der Farbe $COLOR_HIGHLIGHT umrandet.
	  Windows 2000: Dieser Wert wird nicht untersttzt.
	$COLOR_MENUBAR - Die Hintergrundfarbe einer Menleiste, wenn der flache Stil eingestellt ist.
	  Abweichend davon liefert $COLOR_MENU die Hintergrundfarbe des aufklappenden Mens.
	  Windows 2000: Dieser Wert wird nicht untersttzt.
	$COLOR_MENUTEXT - Farbe des Mentextes
	$COLOR_SCROLLBAR - Grauzone (Hintergrund) einer Scroll-Leiste
	$COLOR_WINDOW - Farbe des Fensterhintergrundes
	$COLOR_WINDOWFRAME - Farbe des Fensterbereichs
	$COLOR_WINDOWTEXT - Farbe des Fenstertextes
@@End@@

###ReturnValue###
Gibt die Rot-, Grn- und Blau-Farbwert (RGB) des angegebenen Anzeigeelements zurck


###Remarks###
Oben genannte Konstanten bentigen #include <WindowsConstants.au3>

Falls der $iIndex Parameter auerhalb des Bereichs ist, ist der Rckgabewert 0. Da 0 jedoch auch ein gltiger RGB Wert ist, sollte man GetSysColor nicht verwenden um festzustellen, ob eine Systemfarbe durch die aktuelle Plattform untersttzt wird. Statt sollte man die GetSysColorBrush Funkion verwenden, welche NULL zurckgibt falls die Farbe nicht untersttzt wird.


###Related###
_WinAPI_SetSysColors


###See Also###
@@MsdnLink@@ GetSysColor


###Example###
@@IncludeExample@@
